Получение списка доступных клиентов по токену

Запрос позволяет получить список клиентов, доступных по токену.

Синтаксис запроса

GET https://b2b-api.go.yandex.ru/integration/2.0/auth/list

Заголовки запроса

  • Authorization: Bearer <OAuth-токен>
    Процесс получения токена описан в разделе Начало работы.

Описание полей ответа

В ответе могут содержаться следующие поля:

Поле Описание Формат
clients Массив clients объектов с информаций о клиентах. Массив объектов

Структура элемента массива clients:

Поле Описание Формат
client_id Идентификатор клиента. Строка
name Имя клиента. Строка
role Роль клиента. Строка

Пример запроса

GET https://b2b-api.go.yandex.ru/integration/2.0/auth/list
...
Authorization: Bearer <OAuth-token>

Пример ответа

Пример ответа на данный запрос выглядит следующим образом:

{
  "clients": [
    {
      "client_id": "beed...e542c",
      "name": "user-name",
      "role": "client"
    }
  ]
}

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

  • 200 — запрос выполнен успешно.
  • 400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
  • 401 — был передан неверный OAuth-токен.